.TH E1432_ARM_MEASURE_MASTER_FINISH 3 E1432
.SH NAME
e1432_arm_measure_master_finish \- Master side measurement manual arm
e1432_arm_measure_master_setup  \- Master side measurement manual arm
e1432_arm_measure_slave_finish  \- Slave side measurement manual arm
.IX e1432_arm_measure_master_finish(3) 3
.IX e1432_arm_measure_master_setup(3) 3
.IX e1432_arm_measure_slave_finish(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_arm_measure_master_finish(E1432ID hw, SHORTSIZ16 ID)
SHORTSIZ16 e1432_arm_measure_master_setup(E1432ID hw, SHORTSIZ16 ID)
SHORTSIZ16 e1432_arm_measure_slave_finish(E1432ID hw, SHORTSIZ16 ID)
.cE
.SH DESCRIPTION

These functions are \fInot\fR normally needed by the typical
application.  They are provided for use only when a measurement must
use multiple VXI mainframes.  The typical single-mainframe application
should simply use \fIe1432_arm_measure\fR instead.

These functions are used in conjunction with \fIe1432_arm_measure\fR
to manually arm a multi-mainframe measurement.

Instead of using these functions, it is possible to use
\fIe1432_set_mmf_delay\fR instead.  However, \fIe1432_set_mmf_delay\fR
is not as reliable.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR.

\fIe1432_arm_measure_master_setup\fR is used to set up modules in the
master mainframe of a multi-mainframe system, before doing the manual
arm.  The \fIID\fR parameter to this function should be a channel that
is in the master mainframe, or a group containing only channels in the
master mainframe.

\fIe1432_arm_measure_slave_finish\fR is used to verify that modules in
the slave mainframes of a multi-mainframe system have all successfully
armed.  This should be called after doing the manual arm.  The
\fIID\fR parameter to this function should be a group containing the
channels from the slave mainframes.

\fIe1432_arm_measure_master_finish\fR is used to clean up the
multi-mainframe manual arm process.  This should be done at the end of
the manual arm process.  The \fIID\fR parameter to this function
should be the same as the \fIID\fR that was originally passed to
\fIe1432_arm_measure_master_setup\fR.

The following sequence should be used to reliably manual arm all
modules in a multi-mainframe setup:

.cS
    e1432_arm_measure_master_setup(hw, master_id);
    e1432_arm_measure(hw, global_id, 0);
    e1432_arm_measure_slave_finish(hw, slave_id);
    e1432_arm_measure_master_finish(hw, master_id);
.cE

In the above code, "master_id" is the ID of a channel or group in the
master mainframe; "global_id" is the ID of a group containing all
channels in the measurement (the same ID that was originally given to
\fIe1432_init_measure\fR); and "slave_id" is the ID of a group
containing the channels in the slave mainframes.  Note that a real
application should check the return values of these functions for
errors.

.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_init_measure, e1432_init_measure_master_finish,
e1432_arm_measure, e1432_trigger_measure, e1432_set_mmf_delay,
e1432_multimain
.ad
